home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / col.z / col
Text File  |  1998-10-20  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. ccccoooollll((((1111))))                                                                  ccccoooollll((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_oooo_llll - filter reverse line-feeds
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _cccc_oooo_llll [_----_bbbb] [_----_ffff] [_----_xxxx] [_----_pppp]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _cccc_oooo_llll reads from the standard input and writes onto the standard output.
  16.      It performs the line overlays implied by reverse line feeds (ASCII code
  17.      ESC-_7777), and by forward and reverse half-line-feeds (ESC-_9999 and ESC-_8888).
  18.      _cccc_oooo_llll is particularly useful for filtering multicolumn output made with the
  19.      _...._rrrr_tttt command of _nnnn_rrrr_oooo_ffff_ffff and output resulting from use of the _tttt_bbbb_llll(1)
  20.      preprocessor.
  21.  
  22.      If the _----_bbbb option is given, _cccc_oooo_llll assumes that the output device in use is
  23.      not capable of backspacing.  In this case, if two or more characters are
  24.      to appear in the same place, only the last one read will be output.
  25.  
  26.      Although _cccc_oooo_llll accepts half-line motions in its input, it normally does not
  27.      emit them on output.  Instead, text that would appear between lines is
  28.      moved to the next lower full-line boundary.  This treatment can be
  29.      suppressed by the _----_ffff (fine) option; in this case, the output from _cccc_oooo_llll may
  30.      contain forward half-line-feeds (ESC-9), but will still never contain
  31.      either kind of reverse line motion.
  32.  
  33.      Unless the _----_xxxx option is given, _cccc_oooo_llll will convert white space to tabs on
  34.      output wherever possible to shorten printing time.
  35.  
  36.      The ASCII control characters SO (\017) and SI (\016) are assumed by _cccc_oooo_llll
  37.      to start and end text in an alternate character set.  The character set
  38.      to which each input character belongs is remembered, and on output SI and
  39.      SO characters are generated as appropriate to ensure that each character
  40.      is printed in the correct character set.
  41.  
  42.      On input, the only control characters accepted are space, backspace, tab,
  43.      return, new-line, SI, SO, VT (\013), and ESC followed by _7777, _8888, or _9999.  The
  44.      VT character is an alternate form of full reverse line-feed, included for
  45.      compatibility with some earlier programs of this type.  All other non-
  46.      printing characters are ignored.
  47.  
  48.      Normally, _cccc_oooo_llll will ignore any escape sequences unknown to it that are
  49.      found in its input; the _----_pppp option may be used to cause _cccc_oooo_llll to output
  50.      these sequences as regular characters, subject to overprinting from
  51.      reverse line motions.  The use of this option is highly discouraged
  52.      unless the user is fully aware of the textual position of the escape
  53.      sequences.
  54.  
  55. FFFFIIIILLLLEEEESSSS
  56.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS_////_uuuu_xxxx_cccc_oooo_rrrr_eeee
  57.           language-specific message file [See _LLLL_AAAA_NNNN_GGGG on _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5).]
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccoooollll((((1111))))                                                                  ccccoooollll((((1111))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      _aaaa_ssss_cccc_iiii_iiii(5)
  76.      _nnnn_rrrr_oooo_ffff_ffff(1), _tttt_bbbb_llll(1) in the _D_O_C_U_M_E_N_T_E_R'_S _W_O_R_K_B_E_N_C_H _S_o_f_t_w_a_r_e _T_e_c_h_n_i_c_a_l
  77.      _D_i_s_c_u_s_s_i_o_n _a_n_d _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l
  78.  
  79. NNNNOOOOTTTTEEEESSSS
  80.      The input format accepted by _cccc_oooo_llll matches the output produced by _nnnn_rrrr_oooo_ffff_ffff
  81.      with either the _----_TTTT_3333_7777 or _----_TTTT_llll_pppp options.  Use _----_TTTT_3333_7777 (and the _----_ffff option of
  82.      _cccc_oooo_llll) if the ultimate disposition of the output of _cccc_oooo_llll will be a device
  83.      that can interpret half-line motions, and _----_TTTT_llll_pppp otherwise.
  84.  
  85.      _cccc_oooo_llll cannot back up more than 256 lines or handle more than 4096
  86.      characters per line.
  87.  
  88.      Local vertical motions that would result in backing up over the first
  89.      line of the document are ignored.  As a result, the first line must not
  90.      have any superscripts.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.